home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2000 #5 / Amiga Plus CD - 2000 - No. 5.iso / Tools / Dev / FPSE_src / docs / readme.txt < prev    next >
Encoding:
Text File  |  2000-01-01  |  6.1 KB  |  207 lines
  1.  
  2.                 FPSE: Free PlayStation Emulator - Win32 Version
  3.              -----------------------------------------------------
  4.  
  5.  
  6. 1. Introduction
  7. 2. Installation
  8. 3. Command Line options
  9. 4. Using script files
  10. 5. Using debugger
  11. 6. Notes to developers
  12. 7. Team
  13. 8. Final credits
  14.  
  15.  
  16. 1. Introduction
  17. ===============
  18. FPSE is a software that emulate the Sony PlayStation (PSX).
  19. If you use FPSE you agree with the conditions in TERMS.TXT
  20.  
  21. Features:
  22. * Good compatibility:
  23.    - all R3000 and many GTE opcodes.
  24.    - Nice graphic and sound output
  25.    - MDEC support.
  26.    - CDROM can run commercial games.
  27.    - I/O emulation.
  28. * Fast because it can use dinamic recompilation.
  29. * Easy plugin technology: some good plugins are already present.
  30. * Memory cards and Rs232 emulation.
  31. * Dual shock emulation.
  32. * Accepts PS_EXE, CPE and COFF images as executables.
  33. * And it's open-source.
  34.  
  35. Win32 version requires:
  36. * 486DX/33
  37. * 8 MB Ram
  38. * A Video card and a keyboard (I hope you have them...)
  39. * Microsoft Windows 95/98/NT4/2000
  40.  
  41. Optional:
  42. * A 3D Video accelerator
  43. * Sound card (it's better if it has an hardware voice mixer)
  44. * A gamepad with force-feedback.
  45. * A mouse
  46. * A CDRom at least 2X
  47. * DirectX 5.0 or higher.
  48.  
  49.  
  50. 2. Installation
  51. ===============
  52. * Unzip the binary package in a directory. Be sure that the original tree
  53.   structure is mantained.
  54. * Run 'FpseCfg.exe', configure the options and select some plugins.
  55.   Click on 'SAVE' button when you finish.
  56. * Put an ORIGINAL Psx cdrom in your drive and run FPSE with 'RUN' button.
  57.  
  58. If you get new plugins, copy them in 'PlugIn' subdirectory and launch again
  59. 'FpseCfg.exe'.
  60.  
  61. The configurator is a new tool added in version 0.08 for managing FPSE.
  62. It's very easy to understand, so I'll give you only some advices:
  63. * If you want to use new option you must alway click on "SAVE": this act
  64.   will write them in FPSE.INI file.
  65. * If you run again FPSECFG, the plugin selected in combo boxes are not the
  66.   same in the FPSE main dir (gpurend, spurend, etc), because NO LoadLibrary()
  67.   function is used for an easy porting.
  68. * When you click on "SAVE" button, plugin are not substituited if the
  69.   read-only attribute is on. So, be sure that this flag is clear before
  70.   mail to me.
  71.  
  72.  
  73. 3. Command Line options
  74. =======================
  75. You can override default settings in FPSE.INI with some command line options.
  76.  
  77. Syntax:
  78.         FPSE [-options] [EXE_FILE]
  79.  
  80. Exe_File    executable to run.
  81. -aFLASH     load 'FLASH' with A/R. Run '-a' only will load 'AR.ROM'.
  82. -bBIOS      Load an original bios image. If 'BIOS' is not present in the
  83.             current directory, it will be searched in BIOS subdirectory.
  84.             if no bios file is specified, bios emulation will be turned on.
  85. -c          Use compiler cpu engine.
  86. -d          Show disassembled PSX code at runtime.
  87. -e          Run debugger.
  88. -i          Use interpreter cpu engine.
  89. -sSCRIPT    Load a script file.
  90. -v          Be verbose, show all read/write accesses to hardware registers.
  91. -?          Display an help screen.
  92.  
  93.  
  94. 4. Using script files
  95. =====================
  96.  
  97. In the command line write:
  98.         FPSE -sStart.bat
  99. if you want to run "Start.bat"
  100.  
  101. Script files can contain the following commands:
  102. * LOAD
  103.     Syntax: LOAD <filename> <address>
  104.   Load <filename> in the system ram at the specified address.
  105.   If <address> is not present, <filename> must be an EXE file.
  106. * RUN
  107.     Syntax: RUN <filename>
  108.   Similar to LOAD command, also it setup PC and SP.
  109.   Filename must be an EXE file.
  110.  
  111. With Script files you can run more demo than other emu's; the load order is:
  112. 1) the BIOS (if not emulated)
  113. 2) LIBPS.exe (it is always loaded if present in the current path)
  114. 3) Script file
  115. 3) Executable written in the command line
  116.  
  117.  
  118. 5. Using debugger
  119. =================
  120. FPSE is also a good system for development and testing of PSX apps.
  121. For that purpose an integrated debugger is included and actived with
  122. the '-e' option.
  123. There is a portable debugger based on a CUI interface; commands available are:
  124.     r <x> <val> : watch regs (x[0..3] return COPx, else return GPR
  125.     b <hexadr>  : set breakpoint at hexadr (if no hexadr break is disabled)
  126.     g           : go
  127.     s           : step
  128.     n           : next
  129.     <ENTER>     : repeat last command
  130.     u <hexadr>  : unassemble at hexadr (if none PC reg is used)
  131.     d <hexadr>  : dump data at hexadr (if none PC reg is used)
  132.     p <hexadr>  : print portname at hexadr
  133.     w <x,hexadr>: write data of type x at hexadr
  134.     h           : display this help
  135.     q           : quit debugger
  136.  
  137.  
  138. 6. Notes to developers
  139. ======================
  140. FPSE SDK is designed to give you a nice enviroment for making new plugins.
  141. Refer to FPSE SDK manual for more informations.
  142.  
  143. Some other notes:
  144. * If you use portable libraries, make the code so that porting will be easy.
  145. * If you write a document, please make it a simple text file.
  146. * NEVER use the registry for saving defaults (Win32 version).
  147.  
  148.  
  149. 7. Team
  150. =======
  151.  
  152. BERO:   CODER ....................................... bero@geocities.co.jp
  153.  
  154. LDChen: CODER ....................................... LDChen@fpse.emuforce.com
  155.  
  156. Mr.Fog: WEB DESIGNER ................................ alex_mrfog@hotmail.com
  157.  
  158.  
  159. The latest version of FPSE is at http://fpse.emuforce.com
  160.  
  161.  
  162. 8. Final credits
  163. ================
  164. most info by Blackbag
  165. http://www.blackbag.org/psx/playstation/playstation.html  (DOWN)
  166.  
  167. more info from rw-pslib source & headers by Rob Withey
  168. http://napalm.intelinet.com/_utils.htm
  169.  
  170. GPU info by k-comm.
  171. http://www3.airnet.ne.jp/kcomm/
  172.  
  173. more GPU, CD-ROM, SPU & GTE info by Doomed/Padua
  174. http://psx.rules.org/psxrul2.shtml
  175.  
  176. more SPU info by bITmASTER
  177. http://members.xoom.com/_bITmASTER_/
  178.  
  179. cygwin32 gcc compiler by GNU/FSF and Cygnus Solutions
  180. http://sourceware.cygnus.com/cygwin/
  181.  
  182. DJGPP compiler by DJ Delorie
  183. http://www.delorie.com
  184.  
  185. RSXNTDJ by Rainer Schnitker eXtensions
  186. http://www.mathematik.uni-bielefeld.de/~rainer/
  187.  
  188. fast inverse-DCT by Independent JPEG Group
  189. http://www.ijg.com
  190.  
  191. SEAL audio Library
  192. http://www.egator.com/seal/
  193.  
  194. ASPI SDK from Adaptec
  195. ftp://ftp.adaptec.com/pub/BBS/developer/
  196.  
  197. Info on pad & memory cards at:
  198. http://www.blackthunder.demon.nl/
  199.  
  200. Info on RS232, IRQ logic & parallel port discovered by me (LDChen)
  201.  
  202. Many demos from Hitmen
  203. http://www.hitmen-console.org
  204.  
  205. Thanks to all people at PSXDEV group
  206. http://www.egroups.com/group/psxdev/
  207.